home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / EDUCMISC / EDUCAID.LZH / STUDY.DOC < prev    next >
Text File  |  1986-11-17  |  24KB  |  592 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                              PC-Study
  23.  
  24.  
  25.  
  26.  
  27.                         PC-Study - Fairware!!
  28.  
  29. Wash 'n Ware Software Products
  30. Back-To-School Division
  31. P. O. Box 91016-199
  32. Baton Rouge, LA 70810
  33.  
  34.  
  35. PC-Study is a program from Wash 'n Ware Software Products, Back-
  36. To-School Division, copyright 1986, all rights reserved, which is 
  37. licensed to any user for non-commercial use.  The program may be 
  38. freely distributed by any registered user to any other user 
  39. provided the entire diskette is copied and no files and no 
  40. programs may be modified.  
  41.  
  42. Fairware is a concept of software distribution that allows free 
  43. distribution of programs and documentation and asks users to be 
  44. fair to an author by providing some small remuneration for 
  45. his/her work.  This differs from the Shareware concept where 
  46. registered users are paid commissions for subsequently registered 
  47. copies.  The fees that are requested by the Fairware distributor 
  48. are modest, and intended to cover the cost of maintaining records 
  49. about registered users, and to provide motivation for additional 
  50. development.  If you use the software, then "BE FAIR" and pay the 
  51. registration fee, please. 
  52.  
  53. IBM is the trademark of IBM Corporation.  PC-Write is a trademark 
  54. of Quicksoft.
  55.  
  56.  
  57.                         PC-Study
  58.  
  59. Overview
  60.  
  61. The PC-Study program provides the capability to utilize the 
  62. personal computer as a question and answer device, with the user 
  63. having the capability to easily develop the questions and 
  64. answers.  The program randomly selects alternate choices and 
  65. presents the information in a multiple choice format. 
  66.  
  67. The program records the number of correct answers to compute an 
  68. ongoing score and this score is displayed at the top of the 
  69. screen.  If more than one question is incorrectly answered, the 
  70. program shuffles the alternative responses and re-asks only the 
  71. missed questions.  In order to review the complete list of 
  72. questions, the user need only began again at the beginning of the 
  73. selection process (at the menu). 
  74.  
  75. The registration fee for PC-Study is $10.00 until March 1, 1987 
  76. and $15.00 thereafter. 
  77.  
  78.  
  79. Program Use
  80.  
  81. The most common use of the program is to practice learning words 
  82. and definitions.  However, there is no restriction to that 
  83. environment as the study material may be questions and answers, 
  84. or states and capitals, or the names of figures and formulas for 
  85. their area, etc.  The program allows you to study a list of 
  86. entries.  Each entry consists of a first part which is one line 
  87. long (i.e. the word), and a the second part which is two lines 
  88. long (i.e. the definition).   Each list must be identified to the 
  89. PC-Study program so that the list may be placed in a 'directory' 
  90. of lists for studying.  In fact, there are few restrictions.  
  91. They are: 
  92.    1)  There must be at least 6 entries (words, questions) in a 
  93.    list. 
  94.  
  95.    2)  There may not be more than 80 characters in a list entry 
  96.    (word, question). 
  97.  
  98.    3)  There must be two lines of 80 characters in the second 
  99.    part of the entry (definition, answer), with the second line 
  100.    being blank if it is not needed. 
  101.  
  102.    4)  There should not be more than about 22 lists in the study 
  103.    'directory' or the choices to study will overflow a page. 
  104.  
  105.    5)  There may not be more that 1000 entries in a single list. 
  106.  
  107.  
  108. Example
  109.  
  110. Suppose that you have a list of words that you must learn the 
  111. definition of, say for your math class.  This list of words can 
  112. each be defined with a couple of lines of definition.  To make up 
  113. a study list, you only need to use a word processor or text 
  114. editor that will prepare a standard ASCII text file.  A good 
  115.  
  116. example is the EDLIN program that comes with PC-DOS/MS-DOS.  
  117. Another is the excellent Shareware program, PC_Write from 
  118. Quicksoft.  Many others exist.  Do be careful of standard word 
  119. processors, because some leave special characters in the file as 
  120. format indicators, etc.  These characters will have a strange 
  121. effect on PC-Study. 
  122.  
  123. Study List File Format
  124.  
  125. The study file simply needs to contain the word/question on one 
  126. line, followed by the two lines of definition/answer that apply, 
  127. one right after the other. That is: 
  128.     word1
  129.     definition line 1 for word 1
  130.     definition line 2 for word 1
  131.     word2
  132.     definition line 1 for word 2
  133.     definition line 2 for word 2
  134.     word3
  135.     definition line 1 for word 3
  136.         (a blank line)
  137.     word4
  138.     definition line 1 for word 4
  139.     definition line 2 for word 4
  140.          etc.
  141.  
  142. Notice that each word and its definition, or each question and 
  143. its answer, take up three text lines.  Text lines are terminated 
  144. in the file with a standard 'carriage return' and 'line feed'.  
  145. No other unusual characters are used or should appear.  (Such 
  146. normal printable characters as the period, the comma, the 
  147. exclamation point, number and so on, may be freely used.) 
  148.  
  149. Another example of a list, using questions and answers might be:
  150.     What is the capital of Texas?
  151.     Austin
  152.         (a blank line goes here)
  153.     What is the capita of Louisiana?
  154.     Baton Rouge
  155.         (a blank line goes here)
  156.     What is capital of the United States?
  157.     Washington, D. C.
  158.         (a blank line goes here)
  159.       etc....
  160.  
  161. Study Directory
  162.  
  163. Once the list is prepared, the list must be added to the 'study 
  164. directory'.  This is simply another file which lists the various 
  165. subjects which may be studied and tells the program where the 
  166. lists are.  The study directory is a file named 'study.dir' and 
  167. should reside in the directory where study.com resides (which is 
  168. where you are running the program from, probably).  You add a 
  169. list of words or questions to the list by selecting the add a 
  170. list function on the PC-Study menu.  
  171.  
  172. Then, PC-Study will ask you for the phrase that you want to use 
  173. in describing the list, such as
  174.           'English Vocabulary Words, pp 19-33'.
  175.  
  176.  
  177. Then, you will describe the complete path to the file 
  178. containing the words/questions and their definitions/answers.  If 
  179.  
  180. you are not using sub-directories, this will be easy.  Be sure to 
  181. give the file's extension if you used one.  Examples of this 
  182. might be: 
  183.      \words\mathword.ch3
  184.          or
  185.      \study\wordlist\engvocab.131
  186.          or 
  187.      list2              (assumes we are in the same directory as
  188.                          the program was.)
  189. for access to three different files.
  190.  
  191. Then you will tell the program whether you are giving words, or 
  192. questions, or things, or whatever you want to call the items you 
  193. have on the first line.  Then you will tell the program what to 
  194. call the things on the next two lines, such as definitions, 
  195. answers, or whatever.  
  196.  
  197. This completes the directory entry.  The entry will be shown to 
  198. you, and if you do not like it, say 'N' that it is not okay.  You 
  199. will then be allowed to recreate the entry.  Once you have 
  200. created the entry, you must use your text processor to edit the 
  201. study.dir file to delete them.  Each directory entry takes four 
  202. lines of text, so if you are deleting one, be sure that you 
  203. delete all four lines.  
  204.  
  205. You can modify an existing directory entry with the 'Modify' 
  206. option on the menu.  Each line of the directory entry will be 
  207. shown to you and you may retype it with any correction that you 
  208. want.  If the text of a directory line is okay as is, simply 
  209. press the return (enter) key, and the line will be left intact.  
  210. To blank out a line, enter at least one blank before you press 
  211. return.
  212.  
  213. Studying the list
  214.  
  215. Now you are ready to study your list.  If you select the 'study' 
  216. option on your menu, you will be shown the directory of available 
  217. study topics and you may then choose one.  If you don't want to 
  218. choose one, type 'q' to quit.  (Don't type the quote marks, just 
  219. the letter to quit.) 
  220.  
  221. When you have chosen a list to study, you will be allowed to 
  222. choose in which sequence you wish to have the list presented to 
  223. you.  For example, you can see the words and select the matching 
  224. definition, or you can see the definitions and select the 
  225. matching word. 
  226.  
  227. Finally, the program will present you with the list you have 
  228. chosen, in the order you have chosen, one element at a time, with 
  229. randomly chosen alternative answers.  If you select the correct 
  230. alternative, you will go on to the next item in the list.  If you 
  231. make an error, the correct choice will be highlighted, and you 
  232. will be given a few moments to study the correct answer.  If you 
  233. tire of seeing the correct answer and want to go on to the next 
  234. list item, simply press the space bar.  To select a response, you 
  235. only need to press the number of the response; you do not need to 
  236. press the 'enter' or 'carriage return' key.  
  237.  
  238. When you have completed the items in the list, you will be shown 
  239. your final score.  Then, if you made any errors, the erroneous 
  240. items will be reshown one at a time, with new alternative 
  241.  
  242. answers, and you may continue to study the shorter list.  When 
  243. you get them all right, the program will return to the study 
  244. menu.  
  245.  
  246. To quit studying
  247.  
  248. If you want to quit studying a list, simply press the letter 'q' 
  249. to return directly to the study menu.  
  250.  
  251.  
  252. Program Installation
  253.  
  254. The program should work equally well on a black and white text 
  255. monitor, or on a graphic monitor.  If you encounter trouble in 
  256. using your system, and you are a reqistered user, send the 
  257. specifications of your system to Wash 'n Ware Software Products 
  258. they will develop a version for you if they can.  (If they 
  259. cannot, they will return your registration fee.) 
  260.  
  261. The required files are the program file, study.com, and the 
  262. directory file, study.dir.  Example lists are provided on the 
  263. distribution diskette for your immediate practice in using the 
  264. program.  Try using engvocab.wb and funny.stf.  The first is a 
  265. legitimate word study list.  The second is simply an example of 
  266. the variability of the use of PC-Study, and is meant to be funny. 
  267.  
  268. Simply copy these files to a working diskette, or to your 
  269. hard disk, using a sub-diretory if you wish.  After having made a 
  270. work-copy, please store your distribution diskette safely away 
  271. and work only on the copy. 
  272.  
  273. To execute the program, make that diskette, disk, or sub-
  274. directory your default directory and in response to the operating 
  275. system prompt type 'study' and press 'enter' or 'carriage 
  276. return'.  Then follow the directions above.  Add your own lists, 
  277. and delete the samples.  
  278.  
  279. Note that the program does a warm boot on the primary disk when 
  280. the program terminates, so your primary disk, (either A: or the 
  281. hard drive) must have COMMAND.COM on it.  COMMAND.COM is not 
  282. supplied by the PC-Study system. 
  283.  
  284. In the event that you have a problem with your screen not 
  285. clearing correctly, you may need to run the installation batch 
  286. file supplied on the distribution diskette.  Try PC-Study without 
  287. doing the INSTALL process first.  Then, if you have a problem, 
  288. you may perform the following INSTALL process.
  289.  
  290. INSTALL Batch file in case of difficulty
  291.  
  292. Before you use PC-Study, it may need to be installed for your 
  293. particular computer, i.e. provided with information regarding 
  294. control characters required for certain functions.  This 
  295. installation is easily perfomred using INSTALL (a .BAT file). 
  296.  
  297.  
  298. Now start the installation by inserting the work-copy in your A: 
  299. drive and making it the default drive by typing A: and pressing 
  300. the return or enter key.  Then type INSTALL and press the return 
  301. key.  Select System installation from the main menu.  Depending 
  302. on your version of PC-Study, the installation proceeds as 
  303. described in the following two sections. 
  304.  
  305.              IBM PC Compatible Display Selection
  306.  
  307. If you use PC-Study without installation, the default screen set-
  308. up will be used.  You may want override this default if you have 
  309. two screens or a multimode screen by selecting another screen 
  310. mode from this menu: 
  311.  
  312. -----------------------------------------------------------------
  313.    Choose one of the following displays:
  314.  
  315.       0) Default display mode
  316.       1) Monochrome display
  317.       2) Color display 80x25
  318.       3) Color display 40x25
  319.       4) b/w   display 80x25
  320.       5) b/w   display 80x25
  321.    
  322.    Which display (enter no. or ^X to exit)  !
  323. -----------------------------------------------------------------
  324.                  IBM PC Screen Installation Menu
  325.  
  326. Each time PC-Study runs, the selected mode will be used, and you 
  327. will return to the default mode on exit. 
  328.  
  329.  
  330.                Non-IBM Compatible Installation
  331.      
  332. A menu listing a mungber of popular terminals will appear, 
  333. inviting you to choose one by entering its number: 
  334.  
  335. -------------------------------------------------------------------
  336.    Choose one of the following terminals:
  337.  
  338.      1) ADDS 20/25/30          15) Lear-Siegler ADM-31
  339.      2) ADDS 40/60             16) Liberty
  340.      3) ADDS Viewpoint-1A      17) Morrow MDT-20
  341.      4) ADM 3A                 18) Otrona Attache
  342.                          .
  343.                          .
  344.                          .
  345.     13) Kaypro II and 4        27) None of the above
  346.     14) Lear-Siegler ADM-20    28) Delete a definition
  347.  
  348.    Which terminal? (Enter no. or ^X to exit):
  349. -----------------------------------------------------------------
  350.                    Terminal Installation Menu
  351.  
  352. If your terminal is mentioned, just enter the corresponding  
  353. number,  and the installation is complete.  Before installation  
  354. is actually perfomred, you are asked the question: 
  355.  
  356. ------------------------------------------------------------------
  357.    Do you want to modify the definition before installation?
  358. ------------------------------------------------------------------
  359.  
  360. This allows you to modify one or more of the values being 
  361. installed as described in the following.  If you do not want to  
  362. modify the terminal definition, just type N, and the installation  
  363. completes by asking you the operating frequency of your CPU (see 
  364. last item in this section). 
  365.  
  366. If your terminal is not on the menu, however, you must define the 
  367. required values yourself.  The values can most probably be found 
  368. in the manual supplied with your terminal. 
  369.  
  370. Enter the number corresponding to None of the above and answer 
  371. the quesitona one by one as they appear on the screen. 
  372.  
  373. In the following, each command you may install is described in 
  374. detail.  Your terminal may not support all the commands that can 
  375. be installed.  If so, just pass the command not needed by typing 
  376. RETURN in response to the prompt.  If Delete line, Insert line,  
  377. or Erase to end of line is not installed, these functions will be 
  378. emulated in software, slowing screen performance somewhat. 
  379.  
  380.  
  381. Commands may be entered either simply by pressing the appropriate 
  382. keys or by entering the decimal or hexidecimal ASCII value of the 
  383. command.  If a command requires the two characters 'ESCAPE' and 
  384. '=', may: 
  385.  
  386. either Press first the ESC key, then the =.  The entry will be 
  387.        echoed with appropriate labels, i.e.  <ESC> =.
  388. or     Enter the decimal or hexidecimal values separated by 
  389.        spaces.  Hexidecimal values must be preceded by a dollar-
  390.        sign.  Enter e.g. 27 61  or $1B 61  or  $1B $3D  which  are
  391.        all equivalent.
  392.  
  393. The two methods cannot be mixed, i.e. once you have entered a 
  394. non-numeric character, the rest of that command must be defined 
  395. in that mode, and vise versa. 
  396.  
  397. A hyphen entered as the very first character is used to delete a 
  398. command, and echoes the text "Nothing". 
  399.  
  400. Terminal type:
  401. ------------------------------------------------------------------
  402. Enter the name of the termanal you are about to install.  When 
  403. you complete the installation,  the values will be stored, and 
  404. the terminal name will appear on the initial list of termianls.  
  405. If you later need to re-install PC-Study for this terminal,  you 
  406. can do that by choosing it from the list. 
  407.  
  408. Send an initialization string to the terminal?
  409. ------------------------------------------------------------------
  410.  
  411. If you want to initialize your terminal when PC-Study starts (e.g. 
  412. to download commands to programmable function keys), you answer Y 
  413. for yes to this question.  If not, just hit RETURN. 
  414.  
  415. If you answer Y, you may enter up to 13 characters for this 
  416. string. 
  417.  
  418. Send a reset string to the terminal?
  419. ------------------------------------------------------------------
  420. Here, you may define a string to be sent to the terminal when PC-
  421. Study terminates.  The description of the intiialization command 
  422. above applies here. 
  423.  
  424. CURSOR LEAD-IN command:
  425. ------------------------------------------------------------------
  426. Cursor Lead-In is a special sequence of characters which tells 
  427. your terminal that the following characters are an address on the 
  428. screen on which the cursor should be placed. 
  429.  
  430. When you define this command, you are asked the follwing 
  431. supplementary questions: 
  432.  
  433.  
  434.  
  435.      CURSOR POSITIONING COMMAND to send between line and column: 
  436.      ------------------------------------------------------------
  437.      Some terminals need a command between the two numbers 
  438.      defining the row and column cursor address. 
  439.  
  440.      CURSOR POSITIONING COMMAND to send after line and column:
  441.      ------------------------------------------------------------
  442.      Some terminals need a command after the two numbers defining 
  443.      the row and column cursor address. 
  444.  
  445.      Column first?
  446.      ------------------------------------------------------------
  447.      Most terminal require the address on the format:  first ROW, 
  448.      then COLUMN.  If this is the case on your terminal, answer 
  449.      N.  If you terminal wants COLUMN first, then ROW, then 
  450.      answer Y. 
  451.  
  452.      OFFSET to add to LINE:
  453.      ------------------------------------------------------------
  454.      Enter the number to add to the LINE (ROW) address.
  455.  
  456.      OFFSET to add to COLUMN
  457.      ------------------------------------------------------------
  458.      Enter the number to add to the COLUMN address.
  459.  
  460.      Binary address?
  461.      ------------------------------------------------------------
  462.      Most terminals need the cursor address sent in binary form. 
  463.      If that is true for your terminal, enter Y.  If your 
  464.      terminal expects the cursor address as ASCII digits, enter 
  465.      N. If so, you are asked the supplementary question: 
  466.  
  467.           2 or 3 ASCII digits?
  468.           -------------------------------------------------------
  469.           Enter the number of digits in the cursor address for 
  470.           your terminal. 
  471.  
  472. CLEAR SCREEN command:
  473. ------------------------------------------------------------------
  474. Enter the command that will clear the entire contents of your 
  475. screen, both foreground and background, if applicable. 
  476.  
  477. Does CLEAR SCREEN also HOME cursor?
  478. ------------------------------------------------------------------
  479. This is normally the case; if it is not so on your terminal, 
  480. enter N, and define the cursor HOME command. 
  481.  
  482. DELETE LINE command:
  483. ------------------------------------------------------------------
  484. Enter the command that deletes the entire line at the cursor 
  485. position. 
  486.  
  487. INSERT LINE command:
  488. ------------------------------------------------------------------
  489. Enter the command that inserts a line at the cursor position.
  490.  
  491. ERASE TO END OF LINE command:
  492. ------------------------------------------------------------------
  493. Enter the command that erases the line at the cursor position 
  494. from the cursor poisiton through the right end of the line. 
  495.  
  496. START OF 'LOW VIDEO' command:
  497. ------------------------------------------------------------------
  498. If your terminal supports different video intensities, then 
  499. define the command that initiates the dim video here.  If this 
  500. command is defined, the following question is asked: 
  501.  
  502.        START OF 'NORMAL VIDEO' command:
  503.        -----------------------------------------------------------
  504.        Define the command that sets the screen to show characters
  505.        in 'normal' video.
  506.  
  507. Number of rows (lines) on your screen:
  508. ------------------------------------------------------------------
  509. Enter the number of horizontal lines on your screen.
  510.  
  511. Number of columns on your screen:
  512. ------------------------------------------------------------------
  513. Enter the number of vertical column positions on your screen.
  514.  
  515. ------------------------------------------------------------------
  516. Delay after CURSOR ADDRESS (0-255 ms):
  517. Delay after CLEAR, DELETE, and INSERT (0-255 ms):
  518. Delay after ERASE TO END OF LINE and HIGHLIGHT On/Off (0-255 ms):
  519. ------------------------------------------------------------------
  520. Enter the delay in milliseconds required after the functions
  521. specified.  Return means 0 (no delay).
  522.  
  523. Is this definition correct?
  524. ------------------------------------------------------------------
  525. If you have made any errors in the definitions, enter N. You will
  526. then return to the terminal selection menu.  The installation data
  527. you have just entered will be included in the installation data
  528. file and appear on the terminal selection menu, but installation
  529. will not be performed.
  530.  
  531.  
  532. When you enter Y in response to this question, you are asked:
  533.  
  534. ------------------------------------------------------------------
  535. Operating frequency of your microprocessor in MHz (for delays):
  536. ------------------------------------------------------------------
  537. As the delays specified earlier are depencing on the operating
  538. frequency of your CPU, you must define this value.
  539.  
  540. The installation is finished, installation data is written to
  541. PC-Study, and you return to the outer menu.  New installation
  542. data is also saved in the inmstallation data file and the new
  543. terminal will appear on the terminal selection list when you run
  544. INSTALL in the future.
  545.  
  546.  
  547.  
  548. Registration
  549. All users are requested to fill out the form below and mail with 
  550. the registration fee ($10 before March 1, 1987, $15 thereafter) 
  551. to: 
  552.              Wash 'n Ware Software Products
  553.              Back-To-School Division
  554.              P. O. Box 91016-199                 Date:___________
  555.              Baton Rouge, LA 70810
  556.  
  557.  
  558. Name: __________________________________________________
  559.  
  560. Address:________________________________________________
  561.  
  562.         ________________________________________________
  563.  
  564.        City:_________________________ State:______  Zip:_________
  565.  
  566. (optional)  Phone: (______) _____-__________    _______________
  567.  
  568.     Primary use for program:_____________________________________
  569.  
  570. _________________________________________________________________
  571.  
  572. _________________________________________________________________
  573.  
  574. _________________________________________________________________
  575.  
  576.     Suggestions:_________________________________________________
  577.  
  578. _________________________________________________________________
  579.  
  580. _________________________________________________________________
  581.  
  582. _________________________________________________________________
  583.  
  584. _________________________________________________________________
  585.  
  586. _________________________________________________________________
  587.  
  588. _________________________________________________________________
  589.  
  590. _________________________________________________________________
  591.  
  592.